home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glcopytexsubimage1dext.z / glcopytexsubimage1dext
Encoding:
Text File  |  2001-04-17  |  9.3 KB  |  134 lines

  1.  
  2.  
  3.  
  4. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT - copy pixels into a 1D texture subimage
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  14.                                   GLint _l_e_v_e_l,
  15.                                   GLint _x_o_f_f_s_e_t,
  16.                                   GLint _x,
  17.                                   GLint _y,
  18.                                   GLsizei _w_i_d_t_h )
  19.  
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  22.      _t_a_r_g_e_t   The target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD
  23.  
  24.      _l_e_v_e_l    The level-of-detail number.  Level 0 is the base image level.
  25.               Level _n is the _nth mipmap reduction image.
  26.  
  27.      _x_o_f_f_s_e_t  A texel offset in the x direction within the texture array.
  28.  
  29.      _x        The x coordinate of the lower-left corner of the pixel rectangle
  30.               to be transferred to the texture array.
  31.  
  32.      _y        The y coordinate of the lower-left corner of the pixel rectangle
  33.               to be transferred to the texture array.
  34.  
  35.      _w_i_d_t_h    The width of the pixel rectangle to be transferred to the
  36.               texture array.
  37.  
  38. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT replaces a rectangular portion of a two-
  40.      dimensional texture image with pixels from the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR
  41.      (rather than from main memory, as is the case for ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT).
  42.  
  43.      The screen-aligned pixel rectangle with lower-left corner at (_x, _y),
  44.      width _w_i_d_t_h and height 1 replaces the portion of the texture array with x
  45.      indices _x_o_f_f_s_e_t through _x_o_f_f_s_e_t+_w_i_d_t_h-1, inclusive. The destination
  46.      rectangle in the texture array may not include any texels outside the
  47.      texture array as it was originally specified.
  48.  
  49.      The pixels in the rectangle are processed exactly as if ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
  50.      been called, but the process stops just before final conversion.  At this
  51.      point all pixel component values are clamped to the range [0, 1] and then
  52.      converted to the texture's internal format for storage in the texel
  53.      array.
  54.  
  55.      It is not an error to specify a subtexture with zero width, but such a
  56.      specification has no effect.  If any of the pixels within the specified
  57.      rectangle of the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the read window
  58.      associated with the current rendering context, then the values obtained
  59.      for those pixels are undefined.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT is part of the EEEEXXXXTTTT____ccccooooppppyyyy____tttteeeexxxxttttuuuurrrreeee extension.  See
  76.      ggggllllIIIInnnnttttrrrroooo for more information about using extensions.
  77.  
  78. EEEERRRRRRRROOOORRRRSSSS
  79.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated when _t_a_r_g_e_t is not one of the allowable
  80.      values.
  81.  
  82.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than zero or greater than
  83.      log (_m_a_x), where _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  84.         2
  85.  
  86.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if xoffset<-TEXTURE_BORDER, or
  87.      (xoffset+width)>(TEXTURE_WIDTH-TEXTURE_BORDER), where TEXTURE_WIDTH and
  88.      TEXTURE_BORDER are the state values of the texture image being modified.
  89.      Note that TEXTURE_WIDTH includes twice the border width.
  90.  
  91.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is negative.
  92.  
  93.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated when the texture array has not been
  94.      defined by a previous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD (or equivalent) operation.
  95.  
  96.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT is executed
  97.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  98.      ggggllllEEEEnnnndddd.
  99.  
  100. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  101.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  102.  
  103.  
  104. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  105.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD and ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT are not supported on
  106.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems.
  107.  
  108.      On IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems, there is a performance benefit when the width
  109.      of the image to be transferred to texture memory is a multiple of 8.
  110.  
  111.      Texture borders are not supported on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems.
  112.      Applications should use borderless textures and GGGGLLLL____CCCCLLLLAAAAMMMMPPPP____TTTTOOOO____EEEEDDDDGGGGEEEE____SSSSGGGGIIIISSSS
  113.      wrap mode.
  114.  
  115.      On HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt systems, if the right side of the image
  116.      to be transferred to texture memory is not the right side of the texture,
  117.      then its index must be a multiple of 32, where index = xoffset+width.
  118.      Otherwise it will generate a GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE error.
  119.  
  120.  
  121. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.